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Abstract 



For years now, although many scientific devices have a 
port for computer connection, the diversity of various con- 
nection types results in lack of software able to use the 
totality of them. This paper presents how to: (1) build 

software drivers with a prototype Application Programming 
Interface API for scientific devices using dynamic libraries 
under various combinations of connection ports, programming 
languages and operating systems, (2) employ these drivers in 
software programs capable of managing more than one device 
at the same time, and (3) use two specific software imple- 
mentations of this whole Mensura (Measurement) System to se- 
lect appropriate built driver, define communication set- 
tings, and collect-store-process-present experimental data. 

Keywords 

Mensurasoft, measurement, devices, dynamic library, pro- 
gramming languages, MS-Windows, Linux, driver 



Introduction 

In this paper, "scientific 
devices" are mainly measure- 
ment devices: pHmeters, volt- 
meters, thermometers etc, but 
sometimes they are actuators: 
motors, heaters, voltage-gen- 
erators etc. Many scientific 
devices can be connected to a 
computer; in the past, usu- 



ally through an ISA, PCI or 
RS-232, but nowadays via USB 
too . 

Sometimes there is soft- 
ware to use them, often there 
is no software. When a soft- 
ware is sold or given with a 
device, it can be used only 
with this device or similar 
devices from the same sup- 



MONDAY 14 SEPTEMBER 2015 



Vl—7 



FUNKTECHNIKPLUS # JOURNAL 



P. DIEUMEGARD 



plier. This causes problems 
to professional scientists, 
as well to teachers of sci- 
ences, and to simple amateurs 
of sciences. Can we imagine 
programs able to manage all 
of them? 

This problem is similar to 
that of office software: how 
to make programs (spread- 
sheets, word-processors etc) 
able to manage all printers - 
not only already existing 
printers, but also the print- 
ers which will appear in the 
next years. The solution is 
similar; by using device dri- 
vers. There is a printer dri- 
ver for each printer, and we 
can make a driver for each 
measurement driver. 

However, there are two dif- 
ferences between office pro- 
grams and scientific pro- 
grams. Scientific devices are 
more various than printers, 
and usually produced in small 
quantities. Scientist often 
must make himself/herself the 



program for his/her aim. 

In the present work we will 
show how to use "scientific 
drivers" from the system Men- 
surasoft named by the Latin 
word mensura which means mea- 
sure. Fig. 1 gives an illus- 
tration of the Mensurasoft 
system architecture: separa- 
tion between programming for 
devices and programming for 
humans is an obvious neces- 
sity . 

The necessity of Drivers 

The construction of scien- 
tific devices is not easy. 
Making a pHmeter is a job for 
specialists, with special 
glasses for the electrode, 
special electronics, correc- 
tion for temperature, etc. In 
the same way, building a pre- 
cise scale to measure weight, 
or an accurate lux-meter are 
works of specialists. These 
specialists can supply a pro- 
gram for their devices, but 
not for others. 




Fig. 1: Mensurasoft System 
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A professional scientist 
needs several scientific de- 
vices. For example, in eco- 
logy, we must measure accu- 
rately temperature AND pH AND 
light: there are not programs 
from devices makers for all 
them. A teacher of sciences 
needs to show to the students 
how to make an experiment. If 
there are several models of 
measurement devices in the 
classroom, with different soft- 
ware, the explanations will be 
very difficult for the tea- 
cher, who dreams about one 
piece of software for all 
these devices. 

Drivers for measurement de- 
vices must be simple and easy 
to use, because science work- 
ers may not have great skills 
in programming. They must be 
usable with a lot of program- 
ming languages, in order to 
be used by many people. 

Dynamic Libraries as 

Drivers 

Dynamic libraries are pie- 
ces of compiled program, with 
functions callable by others 
programs; they are standard- 
ized and available in major 
operating systems: MS-Win- 
dows, Linux (named "shared ob- 
jects") and Mac-OS [1] . Many 
programming languages can ma- 
ke dynamic libraries, often 
available as free software, 
but they must be compiled 
ones, such as: C/C++, Pascal, 
and some kinds of Basic. 



On the other hand, almost 
all programming languages can 
use dynamic libraries, inclu- 
ding office software such as 
Openoffice/LibreOffice, or the 
calculation specialists for 
example FreeMat [2], Scilab 
[3] Julia [4], R [5], and 
tools for general programing 
as Basic, C/C++, Pascal, Py- 
thon, Ruby, Rebol. 

In order to use dynamic li- 
braries for all scientific de- 
vices, we must standardize the 
functions, giving them the 
same name in all the drivers. 
"Mensurasoft system" is a pro- 
posal for a possible stan- 
dard: the names are short and 
consist of combination of let- 
ters . 

Fundamental functions and 

additional properties 

Computer must receive mea- 
sures from the measurement 
device, and the driver needs 
a function for this input. In 
Mensurasoft system, the name 
of this input function has 
the letter "e" (as "entree" 
in French, "eingang" in Ger- 
man, "entrada" in Spanish, 
"entrata" in Italian and "en- 
try" in English). This is the 
main job. 

If the device has an actu- 
ator, computer must send a 
value to the device, in order 
to change its state. In Men- 
surasoft system, the name of 
this output function has the 
letter "s" (as "sortie" in 



French, "salida" in Spanish). 

Inputs and outputs can be 
digital or binary if there 
are only two values as "yes/ 
no", "1/0", "on/off", repre- 
sented with the letter "b" in 
Mensurasoft. They are analog 
if there are a great number 
of values, for example when 
we measure temperature, volt- 
age or pH: in Mensurasoft, 
the letter is "a" for them. 

Computers use different ty- 
pe of numbers: integers or 
reals ("floating"). Reals are 
often coded as "double" (dou- 
ble precision), using 8 bytes 
(64 bits), and integers can 
be coded on 4 bytes (32 
bits). When the result of an 
input function (or the value 
to be set by an output func- 
tion) is an integer, there is 
no special letter, but when 
the result or the value is a 
"double", a letter "d" is 
added . 

Sometimes (often) there 
are several inputs. For exam- 
ple, the little Arduino Uno 
has 6 analog inputs; a simple 
thermometer only measures tem- 
perature at one sensor, but 
we could have the results ei- 
ther in kelvins or in Celsius 
or even in Fahrenheit system, 
thus three (3) analog inputs 
are needed. So the input 
functions have one parameter 
meaning the channel for mea- 
surement which is usually 
coded as integer without a 
special letter; 0 corresponds 



to the first channel, 1 to 
the second and so on. 

Output functions have two 
parameters. The first is the 
number of the channel, as for 
input functions, and the sec- 
ond is the value to be set by 
the device (integer or "dou- 
ble"). 

In programming languages, 
there are several ways to 
pass parameters to a function: 
stdcall, cdecl, pascal, and 
others, "stdcall" is more used 
in Windows world, "cdecl" in 
Linux world, but this is no 
mandatory. In order to use 
all of them, we must put a 
prefix "std" if the declared 
function is "stdcall" and "c" 
if the function is "cdecl". 

For example, in Mensura- 
soft system, the first analog 
input channel sending a real 
(double) is stdead(0) with 
the calling convention "std- 
call"; the second binary out- 
put is stdsb(l,l) if it is 
set to "On" and stdsb(l,0) if 
it is set to "Off"; with 
"cdecl" convention, the third 
binary input is ceb(2) and the 
fourth analog output set to 
3.44 is csad(3, 3.44). 

That is enough for main 
programming languages, but 
there are some among them 
which want other functions. 
Some languages accept parame- 
ters only as "double", even 
for the channel number: in- 
stead of "d", we put "double" 
to show that all parameters 
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and results are in double pre- 
cision. Some languages deals 
with parameters and results 
only as "strings": we can add 
"str" at the end, and then 
the word stdeastr (0), for 
example, stands for the first 
analog input. Others need spe- 
cial functions (R, Scilab) in 
the dynamic library, but they 
are not included in the pre- 
sent work. A detailed outline 
of the naming procedure for 
functions in the Mensurasoft 
system is shown in Fig. 2. 

Additional string 

functions 

In Mensurasoft system each 
numerical function as already 
has been mentioned above has 
its name, coded by a string 
of characters. This string is 
a null-terminated string, as 
pchar in Pascal, zstring in 
FreeBasic, s in PureBasic or 
LPTSTR in C++. The name of 
the function begins by a "n" 
(as "name", "nom", "nomo", no- 
me", "nombre"), e.g. nead(l) 
is the name of the second 
analog input. If a numerical 
function does not exist, its 
name is an empty string, i.e. 
a string whose length is 0; 
for example, cnead(133) is 
usually an empty string, be- 
cause normal devices have 
only a few channels for mea- 
surement . 

These "name functions" are 
very useful since: 



a. when we do not know the 
channels of the device: we 

can ask cnead(0), cnead(l), 
cnead(2) and so on in order 
to find out them 

b for general purpose soft- 
ware with menus and dialog 
boxes: to show all analog in- 
puts the programmer is able 
to use a loop, asking the na- 
me of the analog input until 
this name is empty. 

Additional string func- 
tions can be added for more 
comfortable use. A function 
"detail" could provide infor- 
mation about the device such 
as the company identity, the 
device name, the programmer's 
name, the date of programming 
etc. Even if there are not 
parameters, the name will be 
cdetail() and stddetail(). We 
could also define a title fun- 
ction, which will send a smal- 
ler string, for example only 
the name of the device, as: 
stdtitre() and ctitre(). This 
small string could be useful, 
e.g., as a title in a dialog 
box . 

An optional function for ca- 
libration stdcalibration(ch) 
and ccalibration(ch) takes a 
string as input and gives a 
string as output. This func- 
tion is useful only for spe- 
cific devices, and the pro- 
grammer can put anything in 
it . 
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Fig. 2: Syntax of measurement function for Mensurasoft 
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A free project 

Dynamic libraries are well 
known, and well standardized 
in programming languages. Men- 
surasoft is only a proposal 
for the adoption of a stan- 
dard for the functions' names 
in order to allow all pro- 
grammers to be able to use 
dynamic libraries of others. 

Until now, all drivers and 
all application programs of 
Mensurasoft system are free 
software. The best license 
for drivers seems to be LGPL 
[6], because the drivers are 
small programs, and the best 
license for application pro- 
grams seems to be GPL [7] . 
Nevertheless, we can imagine 
non-free drivers and non-free 
application programs, co-op- 
erating with free drivers and 
applications . 

Three frequently asked que- 
stions need to be answered: 

a. how to get existing drivers 

b. how to make new drivers, 

c. how to build programs cal- 
ling them 

a. The repository of the de- 
veloped drivers for a lot of 
devices is at : 

http : //sciencexp .free.fr 

mainly in French [8], but Goog- 
le Translate may provide a 
decent translation for other 
languages. In this site, the- 
re are also application prog- 



rams for Windows and Linux. 
They can use three (3) chan- 
nels, for three (3) different 
drivers, make a graph of mea- 
sured values, and save the 
values in files. They can 
transform the measured values 
by a formula (for example, to 
transform tension in volts 
from a pH-meter with analog 
output to pH). They are mul- 
tilingual by language files. 

Mensurasoft -PB [9] is writ- 
ten in PureBasic. A booklet 
in pdf is available in French, 
English, Spanish and Esperan- 
to. Another program, Oscillo- 
PB, is very similar to Mensu- 
rasoft-PB, but is designed 
for fast measurement, like an 
oscilloscope. Fig. 3 shows a 
window from Mensurasoft -PB . 

Mensurasoft - LZ is written 
in FreePascal/Lazarus . A book- 
let in pdf is available in 
French, English and Esperan- 
to language. Fig. 4 shows an 
example of its usage in Linux 
illustrating the behavior of 
a common capacitor. 

b. The best way to build a 
new driver is to modify an 
existing driver found on [8] . 
You can modify a "true dri- 
ver" for a real device, or a 
"demonstration driver" [10] . 

Available drivers are in 
Delphi, FreePascal and Laza- 
rus, FreeBasic, PureBasic, 
Oxygen-Basic, CodeBlocks, Dev 
-C++, C++Builder, Visual-C++. 
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|[gflrduino:EAD(V):i.650\A:EAl (V):1.621 1 |SAO. 



Files devices settings Experiment settings Edition Measurement ? 




Fig. 3: An example window from Mensurasoft -PB 



For example, if you have a 
new pH-meter, you can modify 
a driver only for a few func- 
tions: stdead, stdnead, std- 
detail, stdtitre. After com- 
pilation, you will be able to 
use Mensurasoft-PB, Mensura- 
soft-LZ and others with your 
new driver, and measure pH 
easily. Details of program- 
ming is available with book- 
lets in French [11], English 
and Esperanto. 

c. The booklets for prog- 
ramming also show how to use 
several languages to call the- 
se dynamic libraries: a lot 
of Basic, C/C++, Pascal, Lo- 
go, Python, Rebol, Ruby, Free- 



mat, Scilab, Julia, R . . . 

Small programs could also 
be found at [12] . 

Conclusion 

Mensurasoft system evolved 
for twenty years, and works 
well, at least for slow mea- 
surement, and for Linux and 
MS-Windows operating systems. 
For fast measurement, like an 
oscilloscope, limitations are 
due to the speed transfer of 
USB. A rather simple but sys- 
tematic notation of functions 
implemented in dynamic li- 
braries has been adopted and 
successfully applied and tes- 
ted. The same system is avai- 
lable for Mac OS, but never 
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has been tested. 

The author encourage those 
who would like to be involved 
to this continuing effort and 
to contribute their driver 
for another device to the 



public domain via a link on 
the website [8] or to share a 
new written related applica- 
tion program. Do not hesitate 
to contact the author for any 
comment or related work. 




Mensurasoft_LZ under Linux: 
Charge and discharge of a capacitor 



(L 
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(AO) 
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Fig. 4: Application of Mensurasoft-LZ in Physics 
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FRONT COVER VIGNETTE 

A faded synthesis of an anthemion rooted in a meandros 

The thirteen-leaf is a symbol for a life tree leaf. 

"Herakles and Kerberos", ca. 530-500 BC, 
by Paseas, the Kerberos Painter, 
Museum of Fine Arts, Boston. 

www. mfa . org/collect ion s/object /plate -153852 

The simple meandros is a symbol for eternal immortality. 

"Warrior with a phiale", ca. 480-460 BC, 

by Berliner Maler, 

Museo Archeologico Regionale "Antonio Salinas" di Palermo, 
commons .wikimedia . org/wiki/File : War rior_MAR_Paler mo_N 12134. j pg 



